home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 083 / phnxdoc.arc / PHNXDOC.13 < prev    next >
Text File  |  1987-12-04  |  8KB  |  199 lines
  1.  
  2.  
  3.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  4.  
  5. 13.0 ONLINE PROGRAMS PROGRAMS EXPLAINED
  6.  
  7.    Online programs or "doors" as it is often referred to is now easier
  8. to set up, and faster than ever to use.  Phoenix can NOW run an online
  9. program from ANYWHERE!  An online program (door) can be executed from
  10. the main menu, the messages menu, the files menu, or any other menu you
  11. choose to set it up on.  (Talk about flexibility!!)  It is most common
  12. to have all of the online programs set up in 1 area, so that is what we
  13. will discuss, but remember that any of the following can be done in ANY
  14. MENU on the system.
  15.  
  16.   First call the online programs menu from another menu (like the
  17. main menu) by adding the following to the main menu.
  18.  
  19. O,[O]nline programs,5,15,z
  20.  
  21. If you don't remember this means that if a user has a security of 15 and
  22. enters an O that Phoenix will activate menu 5.
  23.  
  24.   A menu (here we are calling menu5.mnu) will have to be created.  The
  25. following is an example of a basic online programs menu.
  26.  
  27. Online Programs,door.hlp,n
  28. T,[T]radewars 500,tw5.bat,15,s
  29. K,[K]ing of the hill,king.bat,15,s
  30. C,[C]hess,chess.bat,15,s
  31. 1,[1] Tradewars Bulletin,twbull,15,d
  32. Q,[Q]uit to Main Menu,0,5,z
  33. X,[X]pert toggle,,10,X
  34. G,[G]oodbye,,4,G
  35. ?,[?]Help with commands,,4,?
  36.  
  37. Briefly the first line says that Online Programs will be displayed at the
  38. command prompt.  Door.hlp will be the help file associated with this menu.
  39. The command n means that this is not a message or a file menu.
  40. T,[T]radewars 500,tw5.bat,15,s means that if t was entered and the user has
  41. a minimum security of 15 that tw5.bat would be SHELLED from Phoenix.
  42. We will discuss the construction of a typical online program batch file a
  43. little farther down in the documentation. K & C are the same as the T
  44. function with the exception that they call different batch files.
  45. 1,[1] Tradewars bulletin,twbull,15,d
  46.  
  47. Many of the online programs (doors) construct bulletins of various types.
  48. (Player rankings, winners list etc.)  If you put this in your Phoenix
  49. directory, you can dump the bulletin DIRECTLY from the menu.  (Alternatively
  50. you could post it in your bulletins or anywhere else you want)
  51. remember that the cci of d means to dump a ascii file, and that the .bbs
  52. and .clr rules apply, so if we have a file called twbull.bbs and the user
  53. enters 1 from our menu, and if they have a minimum security of 15 they
  54. will be dumped the file.
  55.  
  56. Q,[Q]uit to main menu,0,5,z
  57.  
  58. Remember that this is a MENU like any other menu, and if you do not allow
  59. the user to QUIT or return to the other Phoenix menus, they will be stuck
  60. there FOREVER (or until carrier is dropped of course), so REMEMBER to allow
  61. them to QUIT to some other menu!!!
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  70.  
  71. G,[G]oodbye,,4,G
  72.  
  73. This is just to show that ANY of the CCI's can be used in the menu, and
  74. you can actually allow the user to logoff the system from your online
  75. programs menu if you wish.  (Or enter messages, or download files or
  76. whatever he might want!)
  77.  
  78. ?,[?] Help with commands,,4,?
  79.  
  80. On the very first line we said that the door.hlp file was the help file
  81. for this menu.  If you construct a help file, REMEMBER to give the user
  82. access to it by putting the ? line in there!!
  83.  
  84.   The BATCH FILES for online programs are simple but there are a few
  85. important things to remember.  In our menu above we put:
  86.  
  87. T,[T]radewars 500,tw5.bat,15,s
  88.  
  89. The batch file that will be SHELLED will be tw5.bat.  Whatever is necessary
  90. to run your "door" or online program is all you need to put it your batch
  91. file.  Example of a batch file to run the tradewars game would be:
  92.  
  93. echo off
  94. cls
  95. cd\Phoenix\doors\tw5
  96. tw5
  97. cd\Phoenix
  98.  
  99. Notice that we DO NOT call any Phoenix files at the end of this batch file!
  100. We are SHELLING from Phoenix, and if we reloaded Phoenix at the end of this
  101. batch file, then you would be shelling Phoenix from Phoenix, and end up with
  102. a real mess!!  After the game has ended, and the batch file is completed
  103. nothing is necessary in the batch file, (no exit or anything) controll will
  104. be returned to Phoenix, and the user will be back at the online programs
  105. menu!  This type of program execution (shelling) is extremly fast and
  106. many of the PCBoard or RBBS doors will at the end of the file say returning
  107. to bbs, please wait 20 seconds!  Phoenix will take probably 1 to 2 seconds
  108. to return to the program!!! (depending on the length of your batch file)
  109. There are some Online programs that will need conversion to run with Phoenix.
  110. The latest copies of the conversion programs will be available at Aztec
  111. or The Sword of Fire (898/1).  If for example you were running the chess
  112. door written for rbbs, a typical batch file might look like:
  113. cd\Phoenix\doors
  114. Copy \Phoenix\info.bbs  (this may or may not be necessary, read the docs
  115. convert                  that accompany the your version of the convert
  116. cd\Phoenix\chess         program you are using.)
  117. chessdor
  118. cd\Phoenix
  119.   There is a file called WATCHDOG that can be used with online programs.
  120. Watchdog will re-boot most computers if carrier is lost.  Many online
  121. programs are released prematurely and contain bugs that will halt the
  122. execution of the program.  If the program you are running does, and you
  123. are NOT running watchdog, the user may drop carrier, and since Phoenix
  124. is not in control of your system (because the door is) your board could
  125. experience DOWN TIME.  It is recommended that watchdog is used with MOST
  126. of the online programs that are available.  Read the applicable
  127. documentation with your online program to see if there is some reason
  128. not to run watchdog.  There are some programs that do NOT have
  129. communications routines in them.  Many of them COULD be run by using
  130. the ctty com1 (or 2) and then ctty con.  Example is a game called advent:
  131.  
  132.  
  133.  
  134.  
  135.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  136.  
  137. echo off
  138. cls
  139. cd\Phoenix\doors\advent
  140. ctty com1
  141. advent
  142. cd\Phoenix\
  143. ctty con
  144.  
  145.   I do NOT recommend using these commands because when you use the ctty com1
  146. everything goes out the port and you will see NOTHING on your screen until
  147. the user is finished with the program.  There is the potential there too
  148. that by using the ctty commands a user COULD end up at DOS in your hard
  149. disk (if the program aborted or failed), so I would recommand NOT using
  150. these commands, but we bring this up to inform you that these types of
  151. programs will work with Phoenix.  (See your dos manual for more info
  152. concerning ctty commands)
  153. There is also a program called cttyaux (or ibmaux) that
  154. will patch the ctty so that it DOES display to the screen (but the user
  155. could still potentially end up in dos! At least with that loaded, if you
  156. are watching, you still have control.)
  157.  
  158.    Finally (just for information), when Phoenix executes a
  159. batch file from a menu (using the s cci), a file called info.bbs is
  160. created.  This is what the online programs (made for Phoenix), or the
  161. conversion programs to make other doors compatible with Phoenix use to
  162. get the users name, baud, time left etc.
  163.  
  164.    If you are having trouble setting up Online Programs on your
  165. system call The Sword of Fire bbs (898/1) and leave a message for the
  166. sysop there, and he will be glad to assist you in whatever you need.
  167. (Leave your net and node number and the sysop will validate you as
  168. visiting sysop).
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.